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About This Manual 


This manual contains the installation instructions for the Mandatory Upgrade. You 
must apply the Mandatory Upgrade kit after performing the installation of 
ULTRIX/UWS Version 4.1 software. 

Before installing the Mandatory Upgrade kit you should do the following: 

• Read the release notes that shipped with your media. Aside from providing 
information that may pertain to the installation and operation of your system, 
the release notes also contain the list of Mandatory Upgrade Subsets with their 
sizes and subset dependencies. 

• Install the supported distribution software. For information on installing the 
supported distribution software, see the appropriate section for your processor in 
the Basic Installation Guide. 

• Read these instructions. 

The Mandatory Upgrade kit distribution contains Mandatory Upgrade subsets. The 
descriptions of the Mandatory Upgrade subsets end with the word "UPGRADE" 
when displayed by the setld utility to distinguish them from other subsets. 

Note 

If you are installing the Mandatory Upgrade kit from the network with 
the rls utility, you must follow these steps: 

1. If you are the system administrator, make the Mandatory Upgrade kit 
available for remote client installations. For information on how to do 
this, read Chapter 2. 

2. If you are a Remote Installation Server (RIS) client, upgrade your system 
after your system administrator makes the Mandatory Upgrade kit 
available for remote client installations. For information on how to do 
this, read Chapter 1, 

The same media can be used for both steps. 


Audience 

The audience for this manual is anyone who is responsible for installing 
ULTRIX/UWS Version 4.1. 



Organization 

Chapter 1 Upgrading Your Installed System 

Describes the Mandatory Upgrade kit installation procedure. 

Chapter 2 Making the Mandatory Upgrade kit Subsets Available for Remote 
Installations 

Describes the Mandatory Upgrade kit procedure for Remote 
Installation Server (RIS) areas. 

Chapter 3 Upgrading Your Diskless Server Environment 

Describes the Mandatory Upgrade kit procedure for existing diskless 
areas. 

Related Documents 

In addition to this document, you should have all of the ULTRIX/UWS Version 4.1 
documents. Because the Mandatory Upgrade kit is installed after installation of the 
supported distribution software, you should keep the following close at hand; 

• The release notes that shipped with your media 

• Guide to Remote Installation Services 

• Basic Installation Guide 

You should also have the hardware documentation for your system and peripherals. 


Conventions 

The following conventions are used in this manual: 

user Input. This bold typeface is used in interactive examples to indicate 
typed user input. 


system output This typeface is used in interactive examples to indicate system 
ou4>ut, and also in code examples and other screen displays. In 
text, this typeface is used to indicate the exact name of a 
command, option, partition, pathname, directory, or file. 

cat (1) Cross-references to the ULTRIX Reference Pages include the 

appropriate section number in parentheses. For example, a 
reference to cat(l) indicates that you can find the material on the 
cat command in Section 1 of the reference pages. 


filename 


UPPERCASE 

lowercase 


In syntax descriptions and function definitions, italics are used to 
indicate variable values; and in text, to introduce new terms or 
give references to other documents. 

The ULTRIX system differentiates between lowercase and 
uppercase characters. Literal strings that appear in text, example, 
syntax descriptions, and function definitions must be typed 
exactly as shown. 
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# 


A number sign is the default superuser prompt. 


<CTRL/jo 


This symbol is used in examples to indicate that you must hold 
down the CTRL key while pressing the key x that follows the 
slash. When you use this key combination, the system sometimes 
echoes the resulting character, using a circumflex (^) to represent 
the CTRL key (for example, '^C for (TTRL/C). Sometimes the 
sequence is not echoed. 
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Upgrading Your Installed System 1 


This chapter describes the steps you should follow to prepare for and complete the 
installation of the Mandatory Upgrade kit for ULTRIX/UWS Version 4.1. 

Chapter 1 contains the following sections: 

• Preparing to Install the Mandatory Upgrade Kit 

• Installing the Mandatory Upgrade Kit 

Note 

If you are installing a new Remote Installation Server (RIS) client from 
an upgraded RIS server, you can install both the supported and the 
upgrade subsets in one step and do not need to perform any of the steps 
listed in this book. To do this, register the client for both the supported 
and the upgrade subsets before booting the client. For more information 
on addressing RIS clients, see the Guide to Remote Installation Services. 


1.1 Preparing to Install the Mandatory Upgrade Kit 

If you are installing the Mandatory Upgrade kit from the network, these instructions 

assume that you have already installed the Mandatory Upgrade kit on your RIS area. 

For more information, see Section 2.1. 

Before installing the Mandatory Upgrade kit, you should: 

1. Read the release notes that shipped with your media. Aside from providing 
information that may pertain to the installation and operation of your system, 
the release notes also contain the list of Mandatory Upgrade Subsets with their 
sizes and subset dependencies. 

2. If your system is not running ULTRIX/UWS Version 4.1 software, install 
ULTRIX/UWS Version 4.1 supported distribution software. For information on 
how to install the supported distribution software, see the appropriate section for 
your processor in the Basic Installation Guide. 

3. If your system is currently running ULTRIX/UWS Version 4.1 software, back 
up your system. For information on how to back up your system, see the Guide 
to Backup and Restore. 

4. Refer to the appropriate section for your processor in the Basic Installation 
Guide to find the load device type and logical unit number you are using for the 
installation. You must also know how to load the distribution media onto your 
software distribution device. See your hardware documentation for information 
on loading your distribution media. 








1.2 Installing the Mandatory Upgrade Kit Software 

Depending on the load device of your processor, you use one of the following 
distribution devices to load the software: 

• TK50 cartridge tape 

• 9-track magnetic tape 

• RA60 disk pack 

• CDROM 

• Network 

The installation procedure makes use of the setld utility and is essentially the same 
for all distribution device types. 

Consult the release notes that shipped with your media for the listing of the media 
labels and the sizes of the upgrade subsets. 

If you must abort the installation for any reason, press CTRL/C. 


1.2.1 Starting the Mandatory Upgrade Installation 

To start the Mandatory Upgrade installation: 

1. Log in to your system as root from the console device. 

2. Bring your system down to single-user mode. Your system must be in single- 
user mode to complete the upgrade. 

The following comnuuid brings the system down to single-user mode after a 
delay of five minutes and broadcasts the message "Applying Mandatory 
Upgrade kit". 

# /etc/shutdown +5 "Applying Mandatory Upgrade kit" 

For more information on shutting down your system, see the Guide to Shutdown 
and Startup and the shutdown(8) reference page. 

3. Unmount all file systems and remount all UFS file systems: 

# /etc/umount -a -f 

# /etc/mount -a -t ufs 

4. Run the /etc/update program to start the daemon that will keep your file 
system consistent: 

# /etc/update 

5. Start the error logger in single-user mode by typing the following comnutnd: 

# /etc/eli “S 

The system will prompt you to confirm that you want to start the error logger. 
Answer yes to the prompt. 
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1.2.1.1 InstdIlinQ from 3 TK50 or MT9 — If you are installing the Mandatory Upgrade kit 
from tape, make sure that it is write-protected. For both TK50 and MT9 tapes, 
follow these steps: 

1. Load the media onto your system’s software distribution device. 

2. Type a command like the following, replacing the italic N with the actual 
logical unit number of the device you are using: 

# /etc/setld -1 /dev/nrmtMi 

The system prompts you to be sure that your distribution device is on line. 

1.2.1.2 Installing from an RA60 or CDROM Disk — If you are installing the Mandatory 
Upgrade kit from an RA60 disk pack, make certain that the disk is write-protected. 
Use the mount command to mount the media. 

1. For an RA60 disk pack, type the following command, replacing the italic N 
with the actual logical unit number of the device you are using: 

# /etc/mount -r /dev/raN /mnt 

For a CDROM, type the following command, replacing the italic JV with the 
actual logical unit number of the device you are using: 

# /etc/mount -r /dev/rzN /mnt 

2. If you are installing to a VAX processor, type: 

# /etc/setld -1 /mnt/VAX/BASE_UPGRADE 

If you are installing to a RISC processor, type: 

# /etc/setld -1 /mnt/RISC/BASE_UPGEADE 

1.2.1 .3 Installing from the Network - After your RIS server is upgraded, you can 
upgrade the registered client systems. If your system is a registered client and you 
are installing from the network, type the following command, replacing server: with 
the name of your RIS server, followed by a colon (:): 

# /etc/setld -1 server: 


1.2.2 Completing the Installation 

Once you have entered the /etc/setld command, the system lists the mandatory 
and optional software subsets and prompts you to select the optional subsets you 
want to install. 

Note that a Mandatory Upgrade subset can only be installed against a corresponding 
subset 

If you are installing from a tape or a CDROM, you should select all subsets. If you 
are installing from the network (RIS), you should select from the menu all subsets 
that end with the word "UPGRADE". 

If you attempt to upgrade an optional subset that was not previously installed, you 
will see a message similar to the following, which you can ignore: 

Subset UDTPGMR410 requires the existence of the UDTPGMR400 
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subset to operate correctly. Please install subset UDTPGMR400 before 
trying to install the UDTPGMR410 subset. 

Once you have entered and verified your selection, the system then copies and 
verifies each subset you selected. 

If at a later time you decide to install an additional subset, be sure to install the 
corresponding Mandatory Upgrade subset as well, if a Mandatory Upgrade subset 
exists for the additional subset you install. 

When the installation is complete, the system returns you to the supemser prompt (#). 

If your distribution media is an RA60 disk pack or CDROM, unmount the disk by 
typing the following command: 

# /etc/umount /mnt 


1.2.3 Rebuilding Your System’s Kernel 

1. Build a new kernel. 

Replace the italic HOSTNAME in the following commands with the name of 
your system typed in all capital letters. 

# /etc/doconf ig -c HOSTNAME 

The -c option specifies that the new kernel be built using the configuration file 
that already exists in the /sys/conf/vax directory for VAX processors, and 
the /sys/conf/mips directory for RISC processors. 

Please note that the doconfig command allows you to edit the configuration 
file. The following prompt appears immediately after you invoke the 
doconfig command with the -c option: 

Do you want to edit the configuration file (y/n) [n]? 

However, only a few configurations require that you edit the configuration file 
at this point. Thus, in almost all cases you should answer no to this prompt. 

The doconfig program then displays the following message as it begins to 
rebuild your kernel: 

*** PERFORMING SYSTEM CONFIGURATION *** 


When the doconfig command finishes, it reports the location of the newly 
built kernel as follows, if your processor is a RISC processor: 

The new kernel is /sys/MIPS/Z/OSTAMAfE/vinunix 


If your processor is a VAX processor, when the doconfig command finishes, 
it reports the location of the newly built kernel as follows: 

The new kernel is /sys/VAX/HOSTNAME/vm\inix 


2. Move the new kernel to the root directory. 

For VAX processors, type the following command, replacing the italic 
HOSTNAME with the name of your processor in all capital letters: 
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# mv /sys/VAX///05rNAM£/vinunix /vmunix 

For RISC processors, type the following command, replacing the italic 
HOSTNAME with the name of your processor in all capital letters: 

# mv /Bys/Ml'PS/HOSTNAME/ynnunLx /vmunix 

The upgrade takes effect when you reboot your system using the new kernel. To 
reboot your system, type: 

# /etc/reboot 
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Making the Mandatory Upgrade Kit Subsets 
Avaiiabie for Remote instaiiations 


2 


This chapter describes the steps you must follow to set up your system’s Remote 
Installation Server (RIS) area. 

You must install the Mandatory Upgrade subsets on your server system before 
installing the Mandatory Upgrade subsets in the server areas. Use the same media 
that you used to upgrade your local system to upgrade your RIS area. 


2.1 Upgrading Your Remote Installation Server (RIS) Area 

Perform the following steps to use the ris utility to upgrade an existing 
/usr/var/adin/ris area: 


Caution 

Be certain that you use the correct media to install the Mandatory 
Upgrade kit in your RIS area. Use VAX media to install the Mandatory 
Upgrade kit to an area serving VAX clients. Use RISC media to install 
the Mandatory Upgrade kit to an area serving RISC clients. 

1. Log in to your system as root, or become superuser. 

2. Load your media onto your software distribution device. 

3. Make sure that your distribution device is write protected. 

For an RA60 disk pack type the following command, replacing the italic N with 
the actual logical unit number of the device you are using: 

# /etc/mount -r /dev/raNc /mnt 

For a CDROM, type the following command, replacing the italic N with the 
actual logical unit number of the device you are using: 

# /etc/mount -r /dev/rzA^c /mnt 

This logical unit number is in the range 0-95. 

4. Type the following command: 

# /ctc/ris 


The system presents the Remote Installation Service Menu. Follow the steps in 
the section entitled "Adding a Product to an Existing Remote Installation 
Environment" in the Guide to Remote Installation Services. 



5. The system prompts you to enter the full pathname associated with the software 
distribution kit device or mount point. If your server upgrade media is a tape, 
enter the following command, replacing the italic N wi^ the actual logical unit 
number of the device you are using: 

/dev/nrmtMi 

This logical unit number is in the range 0-31. 

6. The system prompts you to make sure that your distribution device is on line. 

If your server upgrade media is an RA60 disk pack or GDROM, and the RIS 
area serves VAX clients, enter: 

/nmt/VAX/BASE_UPGRADE 

If your server upgrade media is an RA60 disk pack or CDROM, and the RIS 
area serves RISC clients, enter: 

/nint/RISC/BASE_UPGRADE 

The ris utility then loads the software subsets. 

7. When the subsets are loaded, the ris utility returns you to the Remote 
Installation Service Menu. Type e to exit. 

8. If your distribution media is an RA60 disk pack or CDROM, unmount the disk 
by typing the following command: 

# amount /mnt 

For more information on remote installations and the ris utility, refer to the Guide 
to Remote Installation Services. 

2.2 Upgrading RIS Clients 

Network installation of the Mandatory Upgrade kit from a RIS server is essentially 
the same procedure as a local installation of the Mandatory Upgrade kit described in 
Chapter 1. The basic difference is that the network is your distribution device. 

You should use the modify sub-option to add the "Mandatory Upgrade kit" product 
for each registered client. When you add new clients, select the "Mandatory Upgrade 
kit" product. 

Your local system must be registered as a RIS client on the server. If your system is 
not registered, see the system manager of the server. 

To install from the network, follow the instructions in Chapter 1, starting with 
Section 1.2. 


Note 

If you are installing a new RIS client from an upgraded RIS server, you 
can install both the supported and the upgrade subsets in one step and do 
not need to perform any of the steps listed in this book. To do this, 
register the client for both the supported and the upgrade subsets before 
booting the client For more information on addressing RIS clients, see 
the Guide to Remote Installation Services. 
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Upgrading Your Diskless Server q 

Environments w 


This chapter describes how to install the Mandatory Upgrade kit to an existing 
diskless environment using the Diskless Management Services utility (dms). 

You must install the Mandatory Upgrade subsets on your server system before 
installing the Mandatory Upgrade kit in the server areas. The Mandatory Upgrade kit 
consists of upgrading the server’s diskless area and rebuilding the clients’ kernels. If 
your server supports multiple diskless areas, you must repeat this process for each 
area. 


Caution 

Be certain that you use the correct media to install the Mandatory 
Upgrade kit to your diskless areas. Use VAX media to install the 
Mandatory Upgrade kit to an area serving VAX clients. Use RISC 
media to install the Mandatory Upgrade kit to an area serving RISC 
clients. 

Perform the following steps to use the dms utility to upgrade an existing diskless 
area; 

1. Shut down all diskless clients, if any are registered. 

2. Back up the diskless environments. 

Load the media onto your software distribution device, if you have not done so 
already. If you are installing the software upgrade from a RA60 disk pack or 
CDROM, use the mount command as follows: 

For an RA60 disk pack, type the following command, replacing the italic N 
with the actual logical unit number of the device you are using: 

# /etc/mo\mt -r /dev/raNc /mat 

For a CDROM, type the following command, replacing the italic N with the 
actual logical unit number of the device you are using: 

# /etc/mount -r /dev/rzNc /mnt 

3. Log in to your system as root or become superuser, and invoke the dms 
utility: 

# /etc/dms 

4. Choose the Install Software option from the Diskless Management Services 
Menu. 

5. The system then presents you with two software installation options. Choose 
the second option, "Add software to Existing Area", from the Diskless Area 
Software Installation Menu. 



6. The system then asks you into which existing diskless environment you want to 
install software, and lists your options. Select the appropriate environment. 

7. The system then prompts you to enter the device special file name or mount 
point of the distribution media. If you are installing from a TK50 tape or MT9 
tape, type the following command, replacing the italic N with the actual logical 
unit number of the device you are using; 

/dev/nrmtMi 

Make sure that the installed media is write-protected. 

For an RA60 disk pack or a CDROM, if you are installing to an area serving 
VAX clients, type: 

/mnt/VAX/BASE_UPGRADE 

For an RA60 disk pack or a CDROM, if you are installing to an area serving 
RISC clients, type: 

/iniit/RISC/BASE_UPGEADE 

8. The system then lists both the mandatory and optional subsets and prompts you 
to enter the subsets that you want to upgrade. 

Select all of the ULTRIX mandatory upgrade subsets that correspond to 
currently installed ULTRIX Version 4.1 subsets. Do not select any upgrade 
subset if its corresponding subset is not installed. For example, if UDTBIN400 
is not installed, do not attempt to install UDTBIN410. Instead, you should first 
install UDTBIN400, then install UDTBIN410. 

If you attempt to upgrade subsets that are not installed, the server is put into an 
unusable state and you have to reinstall the Mandatory Upgrade Kit. 

If you attempt to upgrade an optional subset that was not previously installed, 
you will see a message similar to the following, which you can ignore: 

Subset UDTPGMR410 requires the existence of the UDTPGMR400 
subset to operate correctly. Please install subset UDTPGMR400 
before trying to install the UDTPGMR410 subset. 

Once you have entered and verified your selections, the system then copies and 
verifies each subset you selected. 

9. If your installation media is an RA60 disk pack or CDROM, use the following 
command to unmount the disk: 

# /etc/umount /mnt 

If your installation media is tape, remove it from the drive. 

10. Your DMS installation is finished. You may now register diskless clients using 
the “add client" sub-option offered by DMS. 

11. For previously registered diskless clients whose area you have selected to be 
updated, use the DMS option of "rebuild kernel" for each client. Then boot the 
client. 
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How to Order Additional Documentation 


Technical Support 

If you need help deciding which documentation best meets your needs, call 800-343-4040 before placing 
your electronic, telephone, or direct mail order. 


Electronic Orders 

To place an order at the Electronic Store, dial 800-234-1998 using a 1200- or 2400-baud modem from 
anywhere in the USA, Canada, or Puerto Rico. If you need assistance using the Electronic Store, call 
800-DIGITAL (800-344-4825). 


Telephone and Direct Mail Orders 


Your Location 

Continental USA, 
Alaska, or Hawaii 

Puerto Rico 
Canada 


International 

Internal* 


CaU 

800-DIGITAL 

809-754-7575 

800-267-6215 


Contact 

Digital Equipment Corporation 

P.O. Box CS2008 

Nashua, New Hampshire 03061 

Local Digital Subsidiary 

Digital Equipment of Canada 

Attn: DECdirect Operations KA02/2 

P.O. Box 13000 

100 Herzberg Road 

Kanata, Ontario, Canada K2K 2A6 

Local Digital subsidiary or 
approved distributor 

SSB Order Processing - WMO/E15 
or 

Software Supply Business 
Digital Equipment Corporation 
Westminster, Massachusetts 01473 


* For internal orders, you must submit an Internal Software Order Form (EN-01740-07). 
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Reader’s Comments 


ULTRIX 

Mandatory Upgrade Installation Instructions 

AV-PCUQC-TE 


Please use this postage-paid form to comment on this manual. If you require a written reply to a software 
problem and are eligible to receive one under Software Performance Report (SPR) service, submit your 
comments on an SPR form. 


Thank you for your assistance. 


Please rate this manual: 

Excellent 

Good 

Accuracy (software works as manual says) 

□ 

□ 

Completeness (enough information) 

□ 

□ 

Clarity (easy to understand) 

□ 

□ 

Organization (structure of subject matter) 

□ 

□ 

Figures (useful) 

□ 

□ 

Examples (useful) 

□ 

□ 

Index (abiUty to find topic) 

□ 

□ 

Page layout (easy to find information) 

□ 

□ 


What would you like to see more/less of? 



What do you like best about this manual? 


What do you like least about this manual? 






Please list errors you have found in this manual- 
Page Description 
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Name/Title TVpt 


Company Datp 


Mailing Address 








































Do Not Tear - Fbld Here and Tape 



n 


TM 


BUSINESS REPLY MAIL 

FIRST-CLASS MAIL PERMIT NO. 33 MAYNARD MA 


POSTAGE WILL BE PAID BY ADDRESSEE 


DIGITAL EQUIPMENT CORPORATION 

OPEN SOFTWARE PUBLICATIONS MANAGER 

ZKO3-2/Z04 

110 SPIT BROOK ROAD 

NASHUA NH 03062-9987 


NO POSTAGE 
NECESSARY 
IF MAILED IN THE 
UNITED STATES 



llllllllllllllilllllllllllllllllllllllllllllllllllll 

• Do Not Tear - Fbld Here - 


Cut 

Along 

Dotted 

Line 































